Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d14/adlib.arc/INSTALL.DOC

Text File | 1991-01-21 | 10.0 KB | 219 lines

1)  ABOUT FM DRIVER FOR WINDOWS 3.0 VERSION 00.90

Many of you who own Adlib and SoundBlaster cards for your PC's have waited
patiently for the ability to use them under Windows 3.0.  The wait is over!!
The enclosed programs will allow you to use the FM synthesis abilities of your
sound card under Windows 3.0.  You will be able to play ROL music files, edit
instruments, and eventually do other neat things as software becomes available.
This driver also replaces the normal boring error beep of Windows with a note
from the sound card.  <see section 4 for more information>

This driver has been written independently by me, Monty Schmidt.  The enclosed
instrument editor, INSTEDIT,  was written by David Giller, and the ROL player
program, PLAYER, was written by both myself and David Giller. This program was
written to support the Adlib card and also the Creative Labs SoundBlaster card
in Adlib compatible mode.  This was done in order to support the largest number
of cards possible with Windows sound support.  If there is interest future
efforts will include support of Voice, CMS, and Midi modes of the SoundBlaster
card.

Programming information for the FM.DRV driver will be available soon for those
people who would like to write Windows Programs which utilize this driver. It
will be released in a seperate file with a .LIB and .H file.



2)  INSTALLING THE DRIVER:

Copy the driver FM.DRV to the directory \WINDOWS\SYSTEM.  This is the directory
in which Windows 3.0 keeps the driver files needed by your system.  This is
assuming of course that you have installed Windows 3.0 in the directory
WINDOWS.  If you have used a different name then you will need to copy it into
the directory SYSTEM underneath the directory in which you installed Windows.

Ok, moving on to installation of the driver, there is a file located in your
Windows directory called SYSTEM.INI.  This file contains information on what
drivers your machine uses when running Windows 3.0.  You will need to use a
text editor such as SYSEDIT or NOTEPAD, or a DOS editor that does not embed
any kind of formatting codes in the file to edit this file.  MAKE SURE AND
MAKE A BACKUP COPY OF SYSTEM.INI BEFORE EDITING IT.  You do not want to lose
this file!!! Look for a line in the file SYSTEM.INI that looks like this:

sound.drv=sound.drv

You need to change this line to the following line:

sound.drv=fm.drv

If you edit this file from inside Windows then you will need to restart
Windows before you can use the new driver.  <Windows loads the sound driver
when it starts executing.>



3)  CREATING A MUSIC GROUP AND ADDING PROGRAMS

If you are a veteran Windows user you can skip this section. It is only here
for those of you who have never created a group or set up programs under
Windows.

Creating the group and program files and icons:

To create a new group for your music related programs you need to select the
File menu under Program Manager.  Select New... and a dialog box will appear
asking if you want to create a Program Group or Program Item.  Click on the
box next to Program Group and then click OK.  Next a dialog box asking the
Description will appear.  Type in Music and then click on OK. Do not worry
about the Group File prompt Windows will create the file name for you. Ok,
now that you have a new group up on the screen, again Select New... from the
Program Managers File menu.  This time select Program Item and click on OK.
Click in the Command Line edit box.  You may type in the path where you
installed the FM software and name of the executable file you want to add.
If you installed the FM software in the directory D:\WINDOWS\FM you would
type in D:\WINDOWS\FM\PLAYER.EXE.  Click on OK and the Player program will
be added to your group.  Repeat this for the program INSTEDIT.EXE and you
are ready to go!



4)  THE ERROR BEEP OF WINDOWS 3.0

The error beep of Windows is generated by windows making a call into the
current sound driver.  With the FM driver loaded the error beep is redirected
to your Adlib or SoundBlaster music card.  This note is generated using voice 1
of the sound card and will use whatever instrument is currently loaded in the
card.  It will change as you play songs and can be set using the included
program InstEdit.  Whenever a hard reset of the machine occurs the instrument is
cleared by the card and no beep will be heard until the voice is reloaded.
Whether the beep is generated or not is still controlled by the sound portion of
the  Windows control panel.  If any program is currently using the driver to
generate music the beep of Windows will not interrupt the music.


5)  REGISTRATION

We are asking that you send us $20.00 if you like the above programs.  This
will allow us to continue to work on supporting the sound capabilities of
the PC and various manufacturers sound cards.  We will attempt to notify you
when updated versions of the software are available.  If you would like us to
mail you a disk with the latest version of the software and all latest
features enabled please include an extra $3.00. Please specify the type of disk
you would like the programs on, 360K or 720K.

Please remember that we are releasing this driver and related programs as we
have yet to see a decent Windows 3.0 driver for FM music generation.  We do
not expect to make a lot of money from this as most people don't send in money
to shareware authors anyway.  Yes you know who you are! <Grin> .. So
the point is, if you think that these programs have some worth while
potential and you'd like to see more from us then send us something, anything!
Registrations will be valid for at least 1 year.  Hopefully we'll have time
to make lots of neat modifications.

Send all registration checks to :
    Monty Schmidt
    1020 E. Johnson #1
    Madison, WI 53703



6) IN THE FUTURE

We are hoping to establish a BBS for Music card support including most brands
of cards and MIDI.  We would like to acquire other cards to attempt to program
drivers for these cards too.  We hope to write articles on programming
the various music cards and release other programs and programming tools to
help those people attempting to support music in their own programs.

As far as the driver goes, we will be attempting to speed up the driver for
those of you with slower machines.  Currently those of you with 25 Mhz 386's
and above will notice no slow down while music is playing in the background.
Those of you with SX's and 286's may notice slow down in Windows while playing
background music.  We will also be expanding the driver to add new features and
would like to hear your suggestions for things you would like to see.



7)  CONTACTING THE AUTHORS:

All suggestions, questions, or bugs may be directed to either of the two
authors at the addresses or phone numbers listed.

--------------------------------------------------------------------------------
Monty Schmidt
1020 E. Johnson #1
Madison, WI 53703
[phone]

CIS   : 73020,2770
GEnie : MONTY.S
--------------------------------------------------------------------------------
David Giller
Box 134
Occidental College
1600 Campus Road
Los Angeles, CA 90041
email : [e-mail]



8)  Liscense Agreement   YOU MUST READ THIS IN ORDER TO USE THE DRIVER!!

SOFTWARE LICENSE

YOU MAY NOT DISTRIBUTE THE DRIVER FM.DRV WITH ANY PROGRAM FOR PROFIT OR
SHAREWARE WITHOUT THE EXPRESS WRITTEN PERMISSION OF MONTY SCHMIDT. YOU MAY
NOT DISTRIBUTE THE PROGRAM INSTEDIT.EXE FOR PROFIT WITHOUT THE EXPRESS WRITTEN
PERMISSION OF DAVID GILLER.  YOU MAY NOT DISTRIBUTE THE PROGRAM PLAYER.EXE FOR
PROFIT WITHOUT THE EXPRESS WRITTEN PERMISSION OF BOTH MONTY SCHMIDT AND DAVID
GILLER.

FM.DRV,INSTEDIT.EXE, and PLAYER.EXE, are not public domain software,
nor are they free software.

FM.DRV is copyright (C) 1991 by Monty Schmidt
INSTEDIT.EXE is copyright (C) 1991 by David Giller
PLAYER.EXE is copyright (C) 1991 by Monty Schmidt and David Giller

No one may modify or patch the FM.DRV, INSTEDIT.EXE or PLAYER.EXE files in any
way, including but not limited to decompiling, disassembling, or otherwise
reverse engineering the program.


A limited license is granted to copy and distribute FM.DRV, PLAYER.EXE, and
INSTEDIT.EXE only for the trial use of others, subject to the above limitations,
and also the following:

1) FM.DRV, PLAYER.EXE, and INSTEDIT.EXE must be copied in unmodified form,
complete with the file containing this license information.

2) FM.DRV, PLAYER.EXE and INSTEDIT.EXE may not be distributed in conjunction
with any other product without a specific license to do so from MONTY SCHMIDT
and DAVID GILLER.

3) No fee, charge, or other compensation may be requested or accepted, except
for operators of electronic bulletin board systems who may make FM.DRV,
INSTEDIT.EXE, and PLAYER.EXE available for downloading as long as the above
conditions are met and there is no specific charge for the download of FM.DRV,
INSTEDIT.EXE, and PLAYER.EXE.

LIMITED WARRANTY

EXCEPT AS PROVIDED ABOVE, MONTY SCHMIDT AND DAVID GILLER DISCLAIM ALL
WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT
TO THE PRODUCT.  SHOULD THE PROGRAM PROVE DEFECTIVE, THE PURCHASER ASSUMES THE
RISK OF PAYING THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION
AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL MONTY SCHMIDT OR
DAVID GILLER BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION
DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE INABILITY TO USE THIS
PRODUCT EVEN IF MONTY SCHMIDT AND/OR DAVID GILLER HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

Use of this product for any period of time constitutes your acceptance of this
agreement and subjects you to its contents.

SoundBlaster is a trademark of Creative Labs.
Adlib is a trademark of Adlib.
Windows 3.0 is a trademark of Microsoft.